<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->
<title>cancel</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_000_000_248">&nbsp;</a>NAME</h4><blockquote>
cancel - cancel printer requests (<b><a href="intro.html#tag_001_003_003">LEGACY</a></b>)
</blockquote><h4><a name = "tag_000_000_249">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

cancel <b>[</b><i>ID</i> ...<b>] </b><i>printer</i> ... 

cancel <i>ID</i> ...<b>[</b><i>printer</i> ...<b>] 
</b></code>
</pre>
</blockquote><h4><a name = "tag_000_000_250">&nbsp;</a>DESCRIPTION</h4><blockquote>
The
<i>cancel</i>
utility cancels printer requests that were made by an
<i><a href="lp.html">lp</a></i>
command.
The cancellation of a request
that is currently printing frees the printer
to print its next available request.
<p>
Cancelling requests from other users requires appropriate privileges.
For each request successfully cancelled by a user
who did not submit the request, the submitter
may be notified that the request was cancelled.
<p>
The
<i>cancel</i>
utility cannot reliably cancel print requests in all conceivable
circumstances.
When the printer is under the control of another
operating system or resides on a remote system
across a network, it might not be possible to
affect the status of the print job after it
has left the control of the local operating system.
Even on local printers, spooling hardware in the
printer may make it appear that the print job
has been completed long before the final page is printed.
</blockquote><h4><a name = "tag_000_000_251">&nbsp;</a>OPTIONS</h4><blockquote>
None.
<br>
</blockquote><h4><a name = "tag_000_000_252">&nbsp;</a>OPERANDS</h4><blockquote>
The following operands are supported:
<dl compact>

<dt><i>ID</i><dd>A
<i>request ID</i>,
as returned by
<i><a href="lp.html">lp</a></i>.
Specifying a
<i>request ID</i>
cancels the associated request even if it is currently printing.

<dt><i>printer</i><dd>A printer name
(for a complete list of printer names, use
<i><a href="lpstat.html">lpstat</a></i>).
Specifying a printer
cancels the request that is currently printing on that printer.

</dl>
</blockquote><h4><a name = "tag_000_000_253">&nbsp;</a>STDIN</h4><blockquote>
Not used.
</blockquote><h4><a name = "tag_000_000_254">&nbsp;</a>INPUT FILES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_255">&nbsp;</a>ENVIRONMENT VARIABLES</h4><blockquote>
The following environment variables affect the execution of
<i>cancel</i>:
<dl compact>

<dt><i>LANG</i><dd>Provide a default value for the internationalisation variables
that are unset or null.
If
<i>LANG</i>
is unset or null, the corresponding value from the
implementation-dependent default locale will be used.
If any of the internationalisation variables contains an invalid setting, the
utility will behave as if none of the variables had been defined.

<dt><i>LC_ALL</i><dd>
If set to a non-empty string value,
override the values of all the other internationalisation variables.

<dt><i>LC_CTYPE</i><dd>
Determine the
locale for the interpretation of sequences of bytes of text data as
characters (for example, single- as opposed to multi-byte characters
in arguments).

<dt><i>LC_MESSAGES</i><dd>
Determine the locale that should be used to affect
the format and contents of diagnostic
messages written to standard error,
and informative messages written to standard output.

<dt><i>NLSPATH</i><dd>
Determine the location of message catalogues
for the processing of
<i>LC_MESSAGES .
</i>
</dl>
</blockquote><h4><a name = "tag_000_000_256">&nbsp;</a>ASYNCHRONOUS EVENTS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_000_000_257">&nbsp;</a>STDOUT</h4><blockquote>
The standard output is a text file containing the status
of each cancellation request,
in an unspecified format.
</blockquote><h4><a name = "tag_000_000_258">&nbsp;</a>STDERR</h4><blockquote>
Used only for diagnostic messages.
</blockquote><h4><a name = "tag_000_000_259">&nbsp;</a>OUTPUT FILES</h4><blockquote>
If mail notification is used to inform users of
their requests being cancelled by other users, mail files
will be modified.
</blockquote><h4><a name = "tag_000_000_260">&nbsp;</a>EXTENDED DESCRIPTION</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_261">&nbsp;</a>EXIT STATUS</h4><blockquote>
The following exit values are returned:
<dl compact>

<dt>0<dd>Successful completion.

<dt>&gt;0<dd>An error occurred.

</dl>
</blockquote><h4><a name = "tag_000_000_262">&nbsp;</a>CONSEQUENCES OF ERRORS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_000_000_263">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_264">&nbsp;</a>EXAMPLES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_265">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>
None.
</blockquote><h4><a name = "tag_000_000_266">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="lp.html">lp</a></i>,
<i><a href="lpstat.html">lpstat</a></i>,
<i><a href="mailx.html">mailx</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
